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ABSTRACT 


The aim of this thesis is to design and implement a 
graphic subsystem for a graphic display terminal with conic 
section capabilities. The display terminal with its associ- 
ated peripheral hardware is connected to a PDP=-11/50 com= 
puter. 

The basic concents and desian principles of graphic sys- 
tems are discussed. A brief description is aiven of the 
particular hardware configuration of the Conographicel2 
display system as installed at the Naval Postgraduate 
School. Concepts incorporated in the desiaqned implementa- 


tion are explained. Recommendations are included for possi= 


ble future extensions of the system's capabilities. 
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I. INTROOUCTION 


The purpose of this thesis is to desian and implement a 
graphic subsystem for a graohic display terminal with conic 
section capabilities. A literature search was performed to 
determine the desirable features of a graphic system and 
plausible means of implementation. The resulting imple- 
mented design provides the applications orogqrammer with a 
library packaae of general ourpose subroutines which cone- 
struct the commands for the Conoaraphic-12 Interactive 
Graphic Display System. 

The Conographicele Display System, as installed at the 
Naval Postaraduate School, is a display terminal interfaced 
with a PDP-il/S0 comouter. The terminal system includes”) an 
alphanumeric keyboards, special program function keyboard, 
joystick, and extendea symbol capability. This terminal 
draws points, straiaht lines, characters, circles, arcs, 
elliosesr and conic curves. As a results major reductions 
in the amount of data required to draw a aiven picture are 
made possible. Data compression means that pictures” take 
less CPU time to manipulate, significantly less storage 
space, and substatially less time to transmit from comouter 


memory to display aevice [3]. 





Dl. @UNTEREAGCE DESTCONM CONCEPTS 


A. UNIVERSAL GRAPHIC LANGUAGE 


One of the major obstacles in defining a aeneral oraphic 
subsystem is that, even among the experts, there is no con-= 
sensus of opinion on what its capabilities should be. Many 
can point out various functions which they would like to see 
in the system, but each person desires different functions. 
The one point on which most do aqree is that, at this time, 
simolicity is more important than efficiency in a graphic 
langquaae. Once a language has been conceived and can be 
used by a wide variety of peonle, then the efficiency of the 
language can be extended. 

Wiseman says it is a Mistake to say that “because we are 
dealing with granhica) thinas, there is a need to invent a 
new language, or perhaps to embellish an existina one"{4]). 
Nhat 1s needed is a rich J|lanquaae able to exoress and mania 
Siubote Comoiwex data Structures. “Whe task of generating pie= 
tures aS a byproduct is easys the comolexity in granohics 
arises from the oroblems of data descripotion and task coor- 
dination. 

William Newman claims we already have a qeneral ourpose 
graohic lancuage in FORTRAN IV. Most orovosed graphics 
packages are based on FORTRAN IV, even thouah it iS not a 


fSarticularly good lanaquaae Gon me It nas to be considered 
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universal because everyone uses it [4]. Extrapolating from 
this arguement anv lanquage with input/output capabilities 
could be considered a general purpose aqraphic lanquage if 
there are no particular requirements that it must meet. 

Several of the exoerts believe that ‘a 1s impossible to 
define a universal araphics language only because graphics 
is not understood well enough. For instance, we do under- 
Stand arithmetic well enough so nobody questions the useful 
ness of a universal arithmetic lanquage. Rosenfeld suggests 
that “we can inculcate araphical thinking at a stage as 
early as arithmetic thinkina 1S now inculcateds, and let the 
next generation design the universal qraphic language" {(4), 

Nells considers set theory a universal graphic language. 
Unordered sets appear in many lanquages. The ordered struce 
tures, lists and arraySe in proaramming lanquages are just 
the sequences of set theory; the procedures are the funce- 
tions of set theory; and lines are naturally considered to 
be sets of points. Reliance should be, wherever oossible, 
on established qeneral mathematical symbolism and convene 
tions, rather than considering particular extensions to 
computersorjiented lanquages that have been developed with 
economics of machine operation as a prime consideration. 
Lanauaqes) should first be desianed Tor man=to-=man 
communication, with concern for the efficiency or imolemen= 
tation on various machines coming later (4). 


Since there are different areas o f araphics with 





different requirements ocerhaps it would be more practical to 
define these areas and their requirements. The different 
areas of graphics include: off-line inputs, recognition, and 
scene analysis? interactive inputs plotting output; line 
drawingss and shaded oictures. Most applications will be 
concerned primarily with one of these graphic areas althouoah 
some applications may deal with a combination of areas, such 
as the field of interactive desian which uses a combination 
of interactive inout and line drawings. The specific needs 
of each area should be researched and defined. Then a 
lanquage can be designed for each area rather than attempt=- 


ing to desian one lanauacge for all araphics areas. 


BeeCURio Ob A GRAPHIC SYSTEM 


Graohic terminals are particularly well adapted to the 
many oroblems which do not yteld exact solutions by a aiven 
algorithm. Such oroblems often require the user's direct 
intervention at different staqes in the computations, man- 
tosmachine dialoguer in order to obtain satisfactory solu- 
tions. The efficiency of such a dialogue demands a rapid, 
Synthetic representation of results as well as asimple, 
flexible, and convenient means of intervention at the user's 
disposal. Graphic terminals allow quick visualization of 


diagrams, araphs, or any picture which would be far more 
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easily internreted than the usual tabulated numerical 
results. Moreover, these terminals, beina equipped with 
joystick, hardware zoom, and alphanumeric and function key- 
boards, become accessible to non-orogrammers [2]. 

Ease of use is one of the principal goals of a araphic 
System. Conseauently, a aqraphic system requires certain 
properties. First, concepts linked with the use of graphic 
terminals have to be clearly set aoart. These basic cone 
cepts must appear in the structure of the application pro 
gram, making the system a "quide for qo0od programmina"™ (ej). 
second, the number of instructions related to interactive 
Geaeohics Should be as small as possible. The goal is to 
make the user's manual a handy reference quige rather than 
an inedepth study. 

Few general ourpose graphic systems would be ahle to 
satisfy comoletely al) the reauirements of a particular 
aoplication. Therefore, an applications proaqramnmer is 
freauently obliaed to develoo a specific system which cone 
tains the features needed to resolve his own particular 
problem. In the araphic subsystem for the Conographicele an 
attemot is made to provide as broad a variety of aqeneral 
OWFOesSe graphic tools as is needed to aive the aeplications 
programmer access to all of the terminal's capabilities. 
The modular nature of subroutine calis facilitates modifica- 
Sirona hnis imeludes the deletion of functions which througna 


utilization are determined to be non-useful, as wel! as the 
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addition of new functions which are deemed desirable. Eon 
this reason, a list of subroutine calls becomes a more effi- 
cient means of implementating an interface than the "“syntace 
tic extension of an existing language” recommended by 


Boullier [2]. 


C. SOFTWARE DESIGN 


The software support required to utilize qraphic devices 
such as the Conographicelie, include machineedependent 
transmissions interruot handling routiness, and processors 
for userworiented lanauages. The design of graohic programs 
begins with an evaluation of other software support avail- 
able to the computer system and the dearee of interaction 
required to incoroorate the aranohic devices [5]. 

A multizslevel design approach is used in the develooment 
of graphic software. There are qenerally considered to be 
four levels. Level one includes subroutines which are 
dependent on the hardware characteristics of the araphic 
device. They perform orimitive operations. Software 
developed at this level orovides the basic tools for pro- 
gramming at the higher levels. Level two orograms comodine 
the facilities available from the operating system with the 
hardware-oriented proarams of level one. This combination 


provides the programs and userworiented l|]anauages to be used 
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at level three. Software development at “level three 
includes user-oriented subroutines which are capable of 
organizing buffer and file manaqement routinesSs and can fore 
mulate graphical instructions and data transmission. Level 
four progamming is application proqams which are directed 
toward the sunport of the non=proarammer [5]. 

The lowest level of this multi-level design is illuse- 
trated in this project. It involves efforts to provide an 
efficient interface for the handlina of signals between the 
comouter and the araphic devices. Progressively hiaher levee 
els of software components can then be developed to increase 
the productivity and utility of the total system. 

The programming activities of this project are primarily 
in the category of level one software design - primitive, 
hardware=oriented subroutines. At the most primitive level, 
Subroutines are used to produce the object code which is 
required to aqenerate images. Examples include code to plot 
a ooint, display a character, draw a vector, etc. At this 
level all the parameters are deviceroriented. That is, the 
subroutines | work with the parameters required by the 
Conographicele. Usinae other subroutines, the screen point 
coordinates and slope values are converted into the device- 
oriented curve oarameters. Userworiented subroutines con- 


vert the user's coordinates to screen coordinates. 
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ITT. HWAROWARE ENVIRONMENT 


The Conographicele Interactive Graphic Nisplay System 
includes raster scan CRI displays alphanumeric keyboard, 
erogram function keyboards, joysticks extended symbol! capa- 
bilitys, and hardware zoom. The coordinate system inherent 
im the hardware iS an tnteaqer address space with the x and y 
coordinate values ranging from -4096 to 4095. The hardware 
includes scale and offset registers which provide the cava- 
bility of varying the ovortion of address space which is 
displayed on the screen. Nhen the scale factor 1S one and 
the offsets are zeror the x coordinates from zero to 2047 
and the y coordinates from zero.to 1536 are visible on the 
screen. 

The storage tube terminal has the basic capabilities of 
displaying vectors and alohanumeric characters. Once writ- 
ten the disnolay remains visible until erased. It is not 
necessary to continually regenerate the output data or 
refresh the screen. The oicture is actually drawn on the 
target Of a video memory utilizina random X-Y deflection. 
The target of the video memory is electronically scanned to 
produce the video signal which the raster scan CRI displays. 
The generator, which supplies the X-Y deflection signals, 
draws conic curves in response to diaital poarameters sup? 
Sisveags trom a computer (3). 


The alohanumeric keyboard has the ability to generate 





all two hundred fifty-six 8=-bit character codes. The key- 
board generates one hundred twentyseight ASCII character 
codes, and there is an additional key to force the parity 
bit to zero or one. This extends the range of codes that 
may be generated to the ful] two hundred fifty=six. The 
alphanumeric keyboard can be enabled/disabled by a command 
from the user's proaram in the host computer. When enabled, 
striking a key qenerates an interrupts, passina the keycode 
to the computer. For the operation of various additional 
keys provided on the keyboard, reference the Conograohicel2 
System Reference Manual [3]. 

The proaram function keyboard consists of thirty-two 
function keys which produce codes that mav be interpreted by 
a proaram in the host comouter. The resultinag action 18 
totally dependent on the proaranm. 

The joystick, when enabled by a program, provides cursor 
positioning control directly to the user. A orogram may 
obtain this positional information by reading the araphic 
display terminal's registers. Other information obtainable 
from the registers are: offset, scale, dash pattern, dash 
frequency, and selected intensity. 

The hardware zoom is completely independent of any opro- 
gram. It provides the user with the capability of dynami- 
cally scaling and positionina the displayed picture in order 
to view a select portion. 


The extended symbol capability orovides the possibility 
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et hewing specialized fonts or sipecial sets of symbols for 
particular acolications. A standard ASCII character font is 
provided. It is implemented in a 4K ROM which is addressed 
as a particular range of the terminal's memory. tWwhen the 
terminal 1s in alohanumeric mode and an 8-bit character code 
is received, execution of the instructions located at the 
address indicated by the sum of the contents of the font 
Baise reeister plus the the S=bit character code gs oer= 
termed. In the standard ASCII character font ROM, this 
first instruction is Ejumo to symbol subroutine® [4]. Thus 
the first 256 locations in the font's adoress space comprise 
a jump table. The symbol subroutine is composed of short 
grapnic commands, thus all capabilities of the terminal are 
accessable except the hardware dash pattern and selectable 
ioerensity. Al} ad@ressingq within a font is relative to the 
value in the font base recister. The address snace of a 
forme 1S twstee to 4056 locations starting wY@A the address 
im the font base reaister [4]. Soecial fonts and symbol 
SECs may be” implemented in the same manner as that just 
described for the standard ASCII character set. The wvartic- 
ular font to be utilized is selected bv settina the font 
base register. The default setting of the font base regis- 


(Sr is the WSCII font. 
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IV. CONTE = CONOGRAPHIC INTERFACE EFFORT 

The Conograohic=12 Interface is a hierarchical set of 
subroutines which can be divided into four general areas: 
Direct Graphics, Virtual Graphics, Alphanumerics, and Con- 
trol Routines. The routines in all these areas provide the 
user interface. This is where the functions as conceived by 
the user are translated into functions which are acceptable 
to the comouter. To provide ease of user every operation 
which 1s functionally different is referred to by a seperate 
Subroutine call. Each subroutine call and its arguements 


are described in Aponendix A of this thesis. 


A, INITIALIZING AND TERMINATING 

To ensure a prooer starting seauencer an initializina 
routine 1S provided and must be called before usina any 
other CONIE routine. The initial state is defined by the 
following four requirements: Cursor and beam are at the HOME 
position(lower left*hand corner); Terminal is in aqraphic 
modes The scaling is set to unity and rotation and offset 
are at zero: Character size is set to two, "normal" condi- 
tione This initializing routine opens filess therefore, it 
must not be recalled prior to calling the terminating 


routine. The terminating routine closes the files. 


ey 





Bee otRee?l GRAPHICS 


Direct araohics utilizes the coordinate system provided 
by the Conoaranhicwr-l2 hardware. Included are scaling and 
offsetting. The facilities for utilizing the conic section 
capabilities are orovided. These include routines to draw 
curves given the ooints and slopes uniquely describing the 
particular curve desired. Curves may be uniquely defined 
by: two points and their associated slope (see figure 1), 
three points and the slope associated with one of these 
points (see figures 2,3 and 4), or three points where the 
slope at the intermediate point is equal to the slove of the 
EnOFG sOIining the endooints (see figure 5). Also included 
are routines for drawing circles, ellipsesr and quarters 
thereof. These figures may be specified by their center and 
lenath of axeS, or their center and one endpoint of each 


axis (see figure 6). 


Ge VIRTUAL GRAPHICS 


To escane the size constraints of the terminal screen, 
the concept of virtual coordinates was implemented. The 
virtual coordinate system 1S an titmaagqinary surface bounded 
only by the range of the floating soint numbers of the come 


Outer system heing used. The user may construct a drawing 
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in any section of the virtual coordinate system that is 
desired. The units of the system have no physical dimen= 
SionsS associated with them. Such a dimension may be arbie 
trarily assumed at the user's convenience. Before con- 
structing the drawing, the user specifies which oortion of 
the virtual coordinates system to be viewed by calling a 
routine. 

The virtual coordinate system facilities are similar to 
those available with direct coordinates. There is one note 
able exception: Virtual coordinates permit distortion = that 
ise the X and Y units may be of different sizes. This 
capability ts not available with direct coordinates. The 
distortion capability precludes oermitting lenaths as param= 
eters for routines (see figure 7). Therefore, the routines 
available with virtual coordinates are only a subset of 


those available with direct coordinates. 


De AL PHANUMERTCS 


Capability is provided for sending a string of charac- 
ters. A character strina, as defined in the "C" Janquage 
[7], is any number of characters, excluding the null charac- 
ter. However, the null character must be included at the 
SoicwOt snesstring to imorcate termination of the character 


strina. A string of characters will normally be interpreted 
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by the Conographic-12 as belongina to the ASCII. character 
set, unless a different set of symbols has been defined and 
the font base register has been loaded to point to this 
other set of symbols. 

There are two modes for sending a string of characters 
to the terminal. The difference between Template Mode and 


Alohanumeric Mode is only a scale (factor o f eight? 


alphanumerics are drawn scaled down by a factor of eiaqht. 


E. CONTROL ROUTINES 

There are various control routines which provide. for 
such functions as rerinitialization?; erasure? ringing the 
keyboard bell; selecting dash patterns and frequencies; and 
setting scale factor, angle of rotation, center of rotation, 
and reflection bits. Other control routines provide for the 
reading of the terminal's reaisters, keyboard characters, 
and the proaram function keys. A contro] routine which 
utilizes the recursive property of the "C" language allows 
large complex structures to be built up in modular fashion 
from small simple structures [1]. At the lowest level of 
complex structures, the extended symbol capabilty can be 


utilized to further simolifv the BUT dingo, St ructumes. 
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Ve. RECOMMENDATIONS 


An assembler or very powerful editor. for building 
extended symbol sets would be a very useful extension to the 
present implementation. This is needed to assist the pro- 
grammer in building the jumo table with the proper 
addresses. 

The addition of higher level routines to plot arrays, 
and to provide curve-fitting and data smoothina is recom= 
mended. The caoability of plottina arrays 18 convenient in 
@avariety of applications. Curveefitting and data smoothing 
combine to take full advantage of the Conographicel2's capa- 
bilities so that data comoression can be fully exoloited. 

The different granohic display terminals at the Naval 
Postgraduate schoo] have uniauely individual hardware 
features. However, in time the capabilities provided by 
their software systems will achieve a high dearee of over= 
lap. At that time it will be feasible to design and implee- 
ment a preprocessor extension to the "C" language [7] which 
will perform the translation to the particular routines for 
the graphic disolay terminal selected at compile time. A 
oroaqram can then be written which can be executed on any or 
all Of the different araohic display terminals simoly by 


recompiling [8]. 
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Vie COUNCEUSIONS 


The Conographicel2 Interface Effort has been designed 


and implemented. As a result of the programming effort 


involved in the production of CONIE, the user can. fully 


utilize the Conographicele and its associated peripheral 


hardware. 
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aeremolxX & = USER'S MANUAL 


A. INTRODUCTION 


This mamas!) tists wa alohabietical order the subroutine 
calls used for sending graphic commands to the Conor 
Graphic<-le terminal. Prior to the execution of a program 
utilizing these calls, the terminal should be turned on and 
placed in mom~iocal mode utilizing the switch orovided on 
the terminal's alohanumeric keyboard. 

lheewarious graohic facilties available are curve draw= 
iNnoir scaling, offsettina, automatic dash oattern for drawe 
ing, reflections, variable intensity, and rotation. Also 
available is the ASCII character font and the capability of 
defining additional fonts. 

To utilize the various subroutines provided, a program 
is written usina castart() as the first graphic cal!) and 
Cigiimiaeleeasetmer last. Thesoarticular.spieture or subpictures 
to be displayed are best described in functions defined by 
the user utilizina the drawing commands such as cgline, 
camove, cgelosar, or cacr22. There are a variety of addi- 
tional drawina commands from which the user may select those 
best suited to his needs. Character outnout intermixed with 
drawing commands can be accomplisked simoly by using the 
caaloh command. If the convention is followed of utilizing 


a seperate function for each suboicture, then the positonina 
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of each subpicture can be easily accomplished using commands 
like cgdrawr. This also simplifies the defining of subpic- 
tures since each has its own set of coordinate axes. Thus 
the user can define independent objects for display and 
later accomplish the relative positioning. 

An illustration of how caqdrawr may be utilized is in the 
segmentation of a display object into its component parts, 
which may have their own symmetry. A simple example would 
be the wheel of a vehicle. For such a case a user would 
write a function defining a wheel, oerhaos with coordinates 
(0,0) for the center hub of the wheel. The vehicle body 
could be defined in a seperate function with the coordinates 
(0,0) possibly at one of the corners of the vehicle. When 
drawing the complete vehicle with wheels, the seauence of 
camove followed with caqdrawr would be utilized. The call to 
camove would be used to position the beam at the end of the 
vehicle's axle. The command cadrawr would be called with 
the wheel function and the proper coordinates of the wheel's 
center as defined by the wheel function as parameters. This 
would effectively place the wheel on the end of the 
vehicle's axle. 

The parameters of scale, rotations, and reflection’ for 
cadrawr provide additional flexibility. With the scale 
parameter available, a user need not concern himself with 
making the units uniform for all subpictures. Instead he 


may utilize the most convenient units for each seperate 
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subpicture and then scale aoprooriately. The rotation 
parameter enables the user to define a subpicture at the 
angle where its coordinates are most easily exoressed, and 
then rotate the subpicture to provide the proper display. 
The reflection parameter provides the capability for exact 
90 degree rotations and subpicture inversions. The center 
for all of these transformations is the beam position when 
the cgdrawr command is executed. 

Control) of the manner in which input coordinate data is 
to be interoreted is provided by the subroutines caginpfm and 
cgvcord. The routine cainofm permits the user to declare 
whether his coordinate data will be expressed in normal 
Cartesian coordinate format or in coordinates relative to 
the beam position. The routine cavcord enables the user to 
specify a floating nmoint coordinate system. The information 
the user provides cgvcord 1s used to set the parameters 
necessary for convertina floating point coordinates into the 
integer coordinate system of the screen, 

Additional subroutines orovide control ot various 
hardware features, some of which are as simple as ringing 
the keyboard bell. Others provide the innut of information 
from the various auxiliary devices, including the 
alohanumeric and program function keyboards. The dash pat- 
tern and selectable intensity are controlled by the routines 
cadofis and cadsi. fhe routine cadpfis is utilized to set 


the pattern and intensity available. The routine cadsi 18 


29 





imserted at appropriate places in the drawing commands” to 
turn on or off the utilization of the dash pattern or 
selected intensity. The ability to erase either the full 
screen or a select object is provided by aaeracen In order 
to erase a oarticular object, cgerase is called for the 
appropriate setting. The commands for drawing the object 
are the rewexecuted to accomplish the erasure, after which 
cgerase is recalled to reset to normal drawing. 

The user's program is compiled, specifying that the 
Conographicetie library be included. The routines available 
in this library and the parameters they require are detailed 


on the  followina oages. The naming convention followed is 


that all start with the letters eq so that the user can 


easily avoid collision of names. Also all routines using 


i] rt 


virtual coordinates start with cav to signify that their 


coordinate parameters are virtual and must therefore be 


floating eoint numbers. 


B. SAMPLE PROGRAM 


// This program draws a simole sketch of a ferris wheel 


// This function defines the labels to be placed on each car 
char *num(7) 
mnt V7 
{ 
Switch(1) { 
case 0: return("0"); 
case 1: return("1i"); 
case ec: return("e"); 
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ease 5: eeturn(*3"); 
case 4: return("4"); 
Gase, 5. return(*’S"); 
case 6: return("6"); 
case 7: return("7"); 
} 


} 


//This function draws the car and calls the label) function 
car(j) 
int i? 
{ 
eqeice(l,0,5); 
egelosa(0,2-50,0.0,20,50)? 
egmove(-5,<-80); // Position for the label 
cgaloh(num(i))? // Outout the label 
} 


mt i? 


// This function draws the arms of the ferris wheel 
// and oositions the cars at their ends 
arm(a,b) 
Tmt a,O- 
{ 
egelpsal(0,0,0.0-a,b0)? 
cgmove(a,0); // Move to the end of the arm 
cagiaws (!1.0,0.0,0,90,0,car,i+0); 
// Set an upright orientation for the car 
} 


// This is the main orogram which initiates and 
// positions the oicture on the screen 
main() 
{ 
cgstart("ferris"); 
cegcersr(0); 
cgmove(1023,800); 
for(i=071<8;71++) cadrawr(1.0,0.39269,1,0,0,arm,500,50); 
// Draw the arm in al) its eight reflections 
egfini(); 
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caalph caalph 


NAME $ 


caalph = emit character string in alphanumeric mode 


SYNOPSIS: 


caaloh(a) 
char al); 


DESERIP TION: 


This routine gelaces the terminal in alohanumeric 
mode and then sends a character string to the terminal. 
Tt returns the beam position to a point one line down 


from the previous position and returns the terminal to 
the previous araphic mode. 


ae nulleterminated character string to be 


sent to 
Conograohicerlied 


SE eles © ¢ 


cotolt 


bite 





cabel] cabel] 


NAME: 
cqbell = ring keyboard bel] 
SYNOPSTS: 


eapeh) () 


DESCRIPTION: 


taser outiwme rings the keyboard bell. 


Bae. 





EqQcirc CEG rc 


NAMES 
eeeirc = draw a circle 
SYNOPSIS: 
ee@e1relayb,t) 
INt asOe-,te 
DESGRIPTIOCN: 
This routine draws a circle when given the center 
point and the radius. The coordinates of the center 


point are shown by a,b. ‘The radius is defined by the 
value of t. 


a .6€° x coordinate of center 
o = y coordinate of center 
t - radius of circle 
SEE ALSO: 

eocure 
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eqgcira Coeitra 


NAMES: 


cgcirq = draw circle auarters 


SYNGPSIS: 


caciralarb,s,drra,se) 
int a-,b,drevae 
float *se; 


Dieser Let TON: 


This routine draws auarters of circles when aiven 
Gnewmmuarues for the Gé&nter points a point on the circle, 
the direction 1n which to draw from this pointy, and the 
number of quarters to be drawn. The present position of 
the beam defines a point on the circle. The center 
point is given by the coordinates a,b. The direction in 
which to draw from the oresent position is defined by 
Gris The number of quarters to be drawn is Shown by ars 
where one quarter is assumed and 3 draws a full circle. 
The address where the value of the ending slope wil! be 
returned is defined by se. 


=) x coordinate of center 
b ” y coordinate of center 
dr- direction of drawing 
One draw clockwise 
jis draw counterclockwise 
q - number of additional quarters 
0: one quarter only 
Ps semiwecircle 
2: two additional quarters, total three quarters 
ise ful) circle | 
se - address of floating ooint variable where endina slope 
can be returned 
SEE ALSO: 


eqerra 
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cgcersr Ccocrsr 


NAME: 
Caeser =acurm Cursor on or of f 
Senor oS : 
egersr (0) 
Vat O7 
DES@RIPT LON: 
This routine enables/disables the joystick. When 


enabled, “whe user can directly control the positioning 
of the cursor by maniodulating the joystick. 


o,)= action flaa 
03 disable the joystick 
\ enable the joystick 
SEG =ae ou: 
GoOrcdece 
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eaqerec eqcree 


NAME: 
cacre2e = draw a curve given 2 points and 2 slopes 
SYNOPSIS: 
cqcereed(xsyrsberse) 
int x,y, 
float sb,se? 
DESCRIPTIONS 
This routine draws a curve when given two points on 
the desired curve and the slopes associated with these 
two ooints. The beginning point of the curve is the 
present oosition of the beam. The coordinates xvsy 
define the endooint. The slove of the beginning point 
is defined by sb. The slooe of the endpoint jis given by 
SC. 
x °° x coordinate of the endnooint 
y = y coordinate of the endpoint 


Se) S slope of the curve at the heginning ooint 


se = slope of the curve at the endpoint 


DIAGNOSTICS: 
The ambiguous case of Oarameters sb=se outputs a 


message to the standard outouts, moves to the specified 
endpoint, and returns a negative value. 


SEE ALSO: 


edersouyeumcocrer5e, cacrs1, coacr3dm, caverec, caver3b, 
Gavetoe, Cdqver5st, caver3m 
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eacrsb coecrse 


NAME: 
cacr3b - draw a curve given 3 points and beqinning slope 
SYNOPSIS: 


cacr3blaqrs,h,x,yr,sor,se) = 
INt Qrehexeryez 
float sob,*se; 


DESCRIPTION; 


This routine draws a curve when given three points 
and the slope at the beainning ooint. The beginnina 
point 1s defined by the present position of the beam. 
The coordinates of the intermediate point are given by 
Qr,h. The endooint is shown by the coordinates xsye The 
slope at the beginning point is defined by sk. The 
address where the value of the ending slope will be 
returned 1S shown by se. 


90:~C« x coordinate of intermediate point 

h = y coordinate of intermediate point 

x x coordinate of the endpoint 

Ve = y coordinate of the endpoint 

so - slope of the curve at the beainnina point 

se - address of fioatina point variable where ending slope 


can be returned 


DIAGNOSTICS: 

If the oarameters describe a curve with an 
inflection point, a messaqe is outout to the standard 
output, the beam is moved to the endpoint, ana a 
negative value 1s returned. 

SEE ALSO: 
cacree, Sacnoes CoCr si, “Cac r lm, cavercc, caver3b, 


egvers3e, caqver3isr, caverim 
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cacrs3e cacrs3e 


NAME ¢ 
caocr3e = draw a curve given 3 points and ending slooe 
SyNOrRSIS: 


caocr3Selaqshsxryrse) 
INt Qrhexery? 
float se; 


DeESsGRIPTITON: 


This routine draws a curve when given the 
coordinates of three points and the slope atthe 
endpoint. The beqinning point is defined by the present 
position of the beam. The intermediate point is shown 
by the coordinates oa,sh. The endpoint is defined by the 
coordinates xrye The slope at the endpoint is given by 


S@-6 

g ° x coordinate of intermediate point 
h y coordinate of intermediate point 
x °° x coordinate of the endpoint 

as y coordinate of the endpoint 

sie = slope of the curve at the endpoint 
DIAGNOSTICS: 


If the parameters describe a curve with an 
inflection point, a message is outout to the standard 
output, the beam is moved to the endpoints, and a 
negative value is returned. 


SEE ALSO: 


Cdemear, “Gace 50, “Ccacrsi, ecaqcr3m-, cavcerec, caver3b, 
GOVGROeC, CAVCF51, cCavcr sm 
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cacr3i cacr3i 


NAME $ 


cegersi -*- draw a curve given 3 points and intermediate 
slope 


SYNOPSIS: 


Gqermosita,hs<s¥rSirse) 
IMt Qrehrxeys 
fioat si,*se?7 


DESCRIPTION: 


This routine draws a curve when given three points 
and the slope at the intermediate point. The beainning 
point is defined by the present position of the beam. 
The intermediate point is aqiven by the coordinates geh. 
The endooint is defined by the coordinates xsry.e The 
slope at the intermediate point is given by Sie The 
address where the value of the ending slope will be 
returned is shown by se, 


9 °° x coordinate of intermediate point 

i) Yy coordinate of intermediate point 

x °° x coordinate of she Gucsatas 

ae y coordinate of the endpoint 

si - slope of the curve at the intermediate point 

se - address of floating ooint variable where ending slope 


can be returned 


DIAGNOSTICS: 
I f the oarameters describe a curve with an 
inflection point, a message is output to the standard 


outout, the beam is moved to the endpoint, and a 
negative value 1S returned. 


SEE AUSO: 


EGierecy, coersd. cacrse, eqcr sme CAVE mec, CaOVEL 50% 
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caver3e, 


CavVCrS)+ 


cavecr3m 
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egcr3m caocr3m 


NAME s 


cocr3m - draw a curve aiven 3. points with the 
intermediate at the relative maximum 


SYNOPSIS: 


cocr3mlaqrhsxryrse) 
INt GQrhsrxrye 
float *se; 


DESERIP TION: 


This routine draws a curve when given three points 
where the slope at the intermediate point is eaual to 


the slove of the chord joining the endpoints. The 
beginning point “is defined by the present position of 
the beam. The intermediate point is shown by the 
coordinates Grhe The endpoint is defined by the 


coordinates x,y. Fhe address where the value of the 
ending slope will be returned is shown by Se. 


9 x coordinate of intermediate point 

h y coordinate of intermediate point 

x oo xecoordtmate of the endooint 

va y coordinate of the endpoint 

se - address of floatina ooint variable where endina slope 
can Dé returned 

SEE “ABSO: 


GOGmec,) §cocrs>, eceacrse, cacrsi, covercec, caver34b, 
cavers3e, caver3i,s caver3m 
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cgdofis egdpfis 


NAME 3 


cgdpfis =~ set dash pattern and frequaqncy and selectable 
intensity 


SYNOPSIS: 


cgdpfislp,f,i) 
int Dre f,r,ie 


DESCRIPTION: 


This routine sets dash pattern, dash frequency, and 
selected intensity level. Draw commands are affected 
only if egdsi has been called setting dash and/or 
intensity select. 


o - l2 bit value definina dash pattern, 1 specifies 
intensification and 0 specifies blankings for example, 
07777 would be a solid line, 0 would be a blank line, 
05252 would be short dashes, 077 would be lona dashes. 


fo = 4 bit value (0-15), this controls the frequency of 
the dash oattern thus determinina the length of the dash 
corresoonding to each bit in the pattern (notes other 
scale factors do not affect the dash oattern) 
1 - 4 bit value (0°15), sets the grey scale level of the 
selectable intensity, 0 is dimmest, 15 18 briahtest, and 
le is the grey scale level of the normal intensity 


SEG Wiese: 


Ccoqsi 
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cadrawa cgdrawa 


y 


NAM 


SYN 


DES 


eS 
cadrawa - set new orientation for user function 
OPSIS: 


CodrawalSsarrexr yr fracrav) 
int Oxf) C),acraverexry3 
float S,a; 


Cer TION: : 


This routine resets the orientation then calls the 
user's function with the two araquements. Scaling is by 
means of the Conographicrie hardware registers therefore 
limited to the range of 1/64 to 635 63/64. Upon return. 
the previous orientation 18 restored. The user's 
function f 1s defined by the user to draw whatever 
subpicture he desires. The parameters ac and av are 
passed to the user's function so that it may have 
oarameters. If more than two Parameters are desired, or 
non=inteqer parameters are desired, the two parameters 
provided can be used to pass a count and a pointer to an 
array of parameters. 


scale to be aoplied 
angle of desired rotation expressed in radians 


reflection desired 
no reflection 
reflect about xtaxis 
reflect about yraxis 
reflect about both axes, (pi rotation) 
reflect about pi/4 line 
Di/e rotation counterclockwise 
01/2 rotation clockwise 
reflect about 3/4 oi line 


NOU OWN © 


x coordinate which will corresnond with oresent beam 
position and be the center of reflection ana rotation 


y coordinate which will correspond with present beam 
D0SItION and be the center of reflection and rotation 


user defined function 
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ac ° first arquement for user ftnction 


av ° second arguement for user function 


SEE ALSO: 


cadrawr, covdrwa, cavdrwr 
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cadrawr cgdrawr 


NAME: 


SYN 


DES 


Ss = 
3 = 
r - 
x = 


y = 


cadrawr - set orientation relative to oresent 
orientation 


OPSIS: 


cadrawr(sSsarrrexcrycrefracrav) 
int (xf) OC) ,acr,aversxcryc? 
float s,a; 


CRIPTIONS: 


This routine sets a new orientation relative to the 
present orientation then calls the user's function. 
Thus the reflections, rotations and scaling are 
cummulative. For best results it is recommended that 
most scaling factors be 1, if the hardware scaling 
provided here is insufficient it 18 recommended that 
virtual coordinates be utilized. Upon return the 
present orientation is restored. The user's function f 
is defined by the user to draw whatever subpicture 15 


desired. The parameters ac and av are passed to the 
user's function so that it may have parameters. If more 
than two parameters are desired, or nontinteager 


oarameters are desired, the two parameters provided can 
be used to pass a count and pointer to an array of 
Parameters. 


Scale to be aoclied 
angle of desired rotation expressed in radians 


reflection desired 
no reflection 
reflect about x-axis 
reflect about y*axis 
reflect about both axes, (01 rotation) 
reflect about 01/74 line 
D1i/e2 rotation counterclockwise 
21/2 rotation clockwise 
reflect about 3/4 pi line 


@e @¢@ @0@ 80@ 88 #@ #8 88 


NOU &WWW © 


x coordinate which will corresnond with oresent bdeam 
position and be the center of reflection and rotation 


y coordinate which will correspond with oresent beam 
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a 


2 
a 


position and be the center o f reflection and rotation 


ty - user defined function 

ac ° first arguement for user function 
av ° second arquement for user function 
SEE ALSO: 


cadrawa, cgovdrwa, cavdrwr 
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cads} 


NAME: 

cqadsi = select dash and/or intensity 
SYNOPSIS: 

ecgasnicd, 4 ) 

YMG’ Gris 
DESCRIPTIONS 


This routine determines whether 


cgds1 


sSusequent drawing 


commands are to be dashed and/or at normal or Selected 


intensity. This routine,is used in 


conjunction with 


cgpdfis which sets the particular oattern and/or 


intensity which is used. 

eg = drawing mode selection 
Or set solid drawina 

j set dashed drawing 


} . intensitv selection 
0 utilize normal intensity (12) 
1 


e 
e 
% 
e 


See ALSO 


Cop dius 
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cgoelosa cgelpsa 


NAME 


cgelpsa - draw an ellipse given center and axes lengths 
and orientation 


SYNOPSIS: 
coelosalars,beremj,mn) 
Int arOemjymn; 
$VOat rs 


peoeriPTION: 


This routine draws an elliose when aiven the center 
901Nt, lenaths9 of the two axes, and the orientation. 


The center point is given by the coordinates a,b. The 
length of the major semiraxis 18 defined by maj. The 
length of the minor semiraxis 1s defined by min. For 


orientations tke anale between the major axis and the 
horizontal 18 given bv r and is written In radians. 


> = x coordinate of center 
o> = y coordinate of center 
r Ue angle of major axis orientation with resoect to the 


x"-3x1S expressed in radians 


mj major semisraxis length 
mn @ minor semisraxis length 
SEES ALSOS 


caelpse, cagelosa, caveloa 
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cgelpose cgelpse 


NAME : 


cagelpse - draw an ellipse given center,sy one axis end and 
other axis length 


SmvgPsiss 


coelpselar,bd,xe,ye,j)a) 
Nt arbre xeryerlas 


VEseRIPTION: 


This routine draws an ellipse when given the center 
pDoINtr one axis endpoint and the length of the other 
semizraxis. The center ooint is shown by the coordinates 
arb. The coordinates of the axis endpoint are given by 
xe, ye. The length of the other semieraxis 1S aQqiven by 
la. 


3 x coordinate of center 

° y coordinate of center. 

x x coordinate of one semizraxis endpoint 
y y coordinate of one semisraxis endpoint 
lq length of other semiraxis 

Sele 2 Stor 


caelpsar cgelpsa, cavelpa 
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cqgelosq cgelpsa 


NAME 


cgelpsq = draw ellinose quarters 


SYNOPSIS: 


cgelosq(arb,xe,yes,q,se) 
Int ar,D0-,xKervyerae 
float *se; 


DESCRIPTION: 


This routine draws the specified number of quarters 
of an ellinse defimed by its center and one endpoint of 
each axis. The ending slope is returned in se. Present 
beam position is taken as the endooint of one axis and 
drawing starts -in the direction of the other axis 
endooint. 


a - x coordinate of center 

Oy y coordinate of center 

xe 2 x coordinate of other axis endpoint 
ye = y coordinate of other axis endpoint 
qe number of additional quarters 


0s one auarter only 

Le semizellipse 

es two additional quarters, total three quarters 
Ss full elliose 


se - address of floating point variable where endina slope 
can be returned : 


SEE Pat sos 


caelpsa, cgelose, cavelog 
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caerase 


CcCgerase 


NAME: 


Saenraoce. er ase SCreen 


SYNOPSIS: 


cgeraselerpw) 
Nt C@erws 


DESERIrTION: 


e =_ 


This routine erases the screen. There are two means 
of doing this. Full screen erase or a selective erase 
can be used. In a selective erase the item to be erased 


1s redrawn after this routine is called to effect the 
erasure. 


erase screen flaa 
0: do not full Screen erase 
1: full screen erase 
writting mode flag 
03 return in normal writting mode 
rs return im selective erasure mode 


ae 





eatin cafini 


NAME : 
cafini = close files 
SYNGPSIS: 


cafini(lfn) 
char fn(); 


BESeRIP TION: 
This routine closes all files that cgstart opens. 


fn = filename used oreviously when calling cgstart 


SEE wESC: 


caostart 
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cqhome cahome 


NAME: 
cghome = initialize 
SYNOPSIS: 


cahome() 


DESCRIPTION: 


bhis routine @@rtorms diselay initialization wien 
cursor in lower leftshand corner of screens, character 
Size=c, picture scale=l1, and rotation angle=0. Offsets 
are zeroed and terminal 1S in qraphic mode. 


SEE AwSO: 


cgostart 
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cginpfm cginpfm 


NAM 


SYN 


DES 


Se 
cginpfm = set input form 
OPSIS: 


caqinofm(o) 
Int o7 


CRIPTION: 


This routine sets the mode in which coordinate 
parameters will be expressed. They may be expressed in 
either Cartesian coordinates (absolute), where 
€oordinates are relative to a fixed oriain,s 8 of in 
relative coordinates, where the beam oosition 1s used as 
the origin so that adjusting one point also adjusts al] 
subsequent onoints. 


selection indicator 


Ors absolute coordinates 
les relative coordinates 
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cgkbd cgkoad 


NAME: 
cakbd = enable/disable keyboard 
SYNOPSIS: 
cakbd(e) 
int e7 
DESCRIPTION: 
This routine turns the alohanumeric keyboard on and 
Ofit. It is automatically called by cgrdkey to turn the 
keyboard on; however, the user must utilize this call if 
he desires the keyboard disabledafter reading. 
\ 
e - action flaa 
08 disable keyboard 
bes enable keyboarda 


Seen oU s 


cardkey 
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caqline caline 


NAME: 


caline = draw a line 
SYNOPSIS: 


caqline(x,y) 
unit <sy? 


DESCRIPTION: 


This routine draws a line from the oresent position 
ont the beam to the endpoint defined by the coordinates 


xryYe 
x - x coordinate of the endpoint 
y = vy eoordinate« of the endpoint 
SEE ALSO: 

caovline 


2) if 








camove 


NAME: 

cgmove = position cursor 
SYNOPSIS: 

camove (x,y) 

Nt Krys 
DESERIPTION: 


This routine moves the beam 
DOSItION without drawina. 


x - x coordinate of the endpoint 
y y coordinate of the endpoint 
SEE ALSO: 
cavmove 
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capfk Edin ft k 
NAME: 


cqgpfk = enable/disable program function keys 


SYNOPSIS: 


cqofk(le) 
Int e- 


DESCRIPTION: 


This routine turns the program function keyboard on 
anmic es 7Ot tf. Tt is automatically called by cardpixk te 
enable the function keys, but must be called by the user 
when he desires to diable the function keys. 


e - action flaa 
0: disable orogram function keys 
lee enable program function keys 
SEE ALSO: 
EQedp tk 
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capoint 


NAME: 
€Gpormt - craw a point 
SYMGPSIS: 


cgpoint(x,y) 
Int xKeye 


DESCRIPTION: 


This routine draws a point at 
position. 


x x coordinate of the point 
y y coordinate of the ooint 
SEE ALSO: 

caqvpoint 
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Garascc caordecc 


NAME s 
cqgrdacc = read accumulator 
SYNOPSIS: 


cardacc(ac) 
mt *ac?; 


DESCRIPTION: 
This routine reads the Conoaraphicele accumulator. 


ac ° address of an inteoer variable where the value from 
the accumulator can be returned 


SEE ALSO: 


cardreg 
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cardcsr cgrdcsr 


NAME: 


cqoracsr = r@ad cursor position 


SYNOPSIS: 


cgordesr(x,y) 
IMt Rxp*Xky? 


DEOURIPTION: 

This routine reads the Conoaqraphicelie present cursor 
pesition. An additional side effect its that the cursor 
‘secummed off orior to reading and turned “on aiter 
reading. 

x - address of an inteaer variable where the x coordinate 


can ove returned 


y °° address of an integer variable where the y coordinate 
can be returned 


SEE ALSO: 


Eqersr, corareg 


ores 





carddsw corddsw 


NAME: 

corddsw - read display status word 
SYNOPSTS: 

corddswil(ds) 

int *ds; 
DESCRIPTION: 


This routine reads the Conoaraphicele display status 
word. 


as = address of an integer variable where the value from 
the display status word can be returned 


The bits have the following meanings (low order bit 0) 


0: Ttacs 
Ls machine check 
Le ofk reauesting attention 
7,63 mode of the display 
00 - alphanumeric 
01 - temolate 
10 - Short araphic 
i = long cGraanitc 
LO=8: reflection state 
eles Grapatc input flaq 
oe FTY switch settine 
Seer aod: 
cgordregq 
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ecor@ibs caordfbs 


NAME; 

cordfoés = read font base 
SYNOPSIS: 

cordfbs( fb) 

Tmt * fb; 
DESCRIPTION: 


This routine reads the address in the font base 
register for the memory of the Conogqraphicelte. 


fb = address of an inteaer variable where the address from 
the font hase register can he returned 


SEE ALSO: 


cordmem, cgqwrmem, cardrea 
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cardkey cgordkey 


NAME: 

cordkey -*- read keyboard characters 
SYNOPSIS: 

cordkey(k,n) 

int nN; 

Char *k; 


DESCRIPTION: 


This routine reads a specified number of characters 
from the Conoagraphiceled alohanumeric keyboard. 


a) = number of characters to be read 


kk - character array of at least size n where characters 
can be returned . 


SEE BLSO: 


Caxodo, cardregq 
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cgqrdmem cgrdmem 


NAME: 
cgrdmem = read memory 
SYMWOPSIS: 
cardmem(b,nyw) 
inet bDerNeX*we 
DESCRIPTION: 
This routine loads tne font base register with the 
SupOolied value and reads the specified number of words 
from memory. 


es value to be loaded into the font base reqister 


n= number of words to be reads this 185 limited to the 
range zero to 4096 


w - array of at least $12e m where the words from memory 
can be returned 


SBE ALSO: 


cawrmem, cordfbs, cardrea 
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eqrdot f 


NAME: 
€areactt = read offset 
SYNOPSIS: 


cardoff(x,y) 
Int *x,*y?; 


DESCRIPTION: 
This routine reads 
offset. 
x - address of an inteaer 


can be returned 


y - address of an integer 
can be returned 


SEE ALSO: 


cqrdreg 


corde tf 


the current Conographicele 


variable where the x coordinate 


variable where the y coordinate 
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ecards k cardpfk 


NAME: 

Cancdptke = = fead program function keys 
SYNORSIS: 

eagicdp ik (ky n) 

int ne 

char xk; 
DESCRIPTION: 


TRIS routine reads a specified number of keycodes 
from the orogram funtion keyboard. 


n= Number of keycoges to be read 
k = character array of at least size n where keycodes can 
be returned 
SEE ALSO: 


eoetik, caqrereq 


68 





cardreg 


NAME: 


GQOreares 


SrNwOroalS: 


cqrareg 


- read all the registers 


cordreg() 


DESCRIPTION: 


This routine reads al] 


Into 


the array cgrea. 


following order: 


OOnNAOMNEWN— Oo 
ee @8@ 4€6@ @0@ 8©80@ @€6@ 44€0@«9€©8@~«8@@ «668 


SEG, SiLS@ : 


x position 

y oosition 

x offset 

y offset 

object scale 
oicture scale 
graohic scale 

font base reaister 
display status word 
accumulator 


caorocsr, caordoff,s cagrdscl, 
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the Conoaraphicete reaqisters 
They are arranged Nn the 


caordfbss carddswe cordacc 





cordscl cgrdscl 


NAME: 

Gerescl = read scales 
SIOPSIS : 

cardscl(p,o0,g) 

IAC *®OHe FO, Xz 
DESCRIPTION: 


This routine reads the scale registers of the 
Conographicele. 


oa address of an integer variable where the value from 
the picture scale register can he returned 


oO, 7 address of an integer variable where the value from 
the object scale register can be returned 


g. a address of an inteaer variable where the value. from 
the graohic scale register can be returned 


SEE ALSO: 


eqranred 
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costart cgstart 


NAME ¢ 
Gqstart = open files and wyty)alize 
SYNOPSIS: 


cgostart(fn) 
char fnfj; 


DESGRIPTION: 


This routine must be called prior to any other. I f 
the parameter fnis present, an outnut file 18S created 
of the display commands that follow; otherwise the files 
associated with the Conographicel2 are opened. 
Initialization performed by this routine is identical to 
that done by caqhome. 


fn filename of file to he created vice writing to the 
Conograohicawle 


SEE ALSO: 


cahome, cafini 


ie 





ea tolit Cato! t 


NAME 3 


cotnplt - emit character string in template mode 


SYNOPSIS: 


catpolt(a) 
char alj; 


DESCRIPTION: 


This routine olaces the terminal in template mode 
and then sends a character string to the terminal. I[t 
returns the heam cosition to a ooint one line down from 
the previous oosition and returns the terminal to the 
previous araophic mode. 


a - nulleterminated character string to he sent to 
Conograohiceie 


SEE ALSO: 


caqaloh 


ve 


=z 
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eaveceord Ccavcora 


NAME: 


cavcord - define virtual coordinates 


SYNOPSIS: 


cqovcord(Ixs,lyserxrryed) 


int ds; 
float Ix,lysrxory? 


DESERIFTION: 


mee 4 


ny 


This routine defines the virtual coordinates by 
specifing the lowereleft point of the screen and the 
uppereright point of the screen. Virtual coordinates 
are still affected by scalina and offset. Definition of 
the virtual coordinates with respect to the screen 
assumes a unity scaling and zero offset. 


minimum x virtual coordinate on the screen 
minimum y virtual coordinate on the screen 
maximum x virtual coordinate on the screen 
maximum y virtual coordinate on the screen 
distortion flaa 


gre do not distort 
lee pemit distortion 
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eamercc eqveread 


NAME: 


caveree = curve given endooints and slooes 


SYNOPSIS: 


caoverec(xsy,sb,se) 
float xry,sbsse; 


DESCRIPTION: 


This routine draws a curve when given two points on 
the desired curve and the slopes associated with these 
two points. The beginning point of the curve is the 
present position of the beam. The coordinates xsy 
define the endpoint. The slope of the beginning point 
is defined by sb. The slope of the endooint is given by 
Se. 


x virtual coordinate of the endpoint 


y y virtual coordinate of the endooint 

sb slope of the curve at the heginnina point 
se slope of the curve at the endpoint 

SEE ALSO: 


cacree2, caocr3be. cacrse, COC oan, cacr3m, cavers3e, 
caver3i, cgver3m 
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eever sb Caverso 


NAME : 


cgover3b = curve given three points and beginning slope 


SYNOPSIS: 


eaversbl(aq,h-,x,y,sb,se) 
float gshsxrye8be%Se; 


DESCRIPTION: 


This routine drawsS a Curve when given three points 
and the slope at the beainningag point. The beginning 
point 1s defined by the present position of the beam. 
The coordinates of the intermediate point are given by 
QGrh. The endpoint is shown by the coordinates xrye The 
slope at the beainning point is defined by sb. The 
address where the value of the ending slope will be 
returned 1S Shown by se. 


g x virtual coordinate of intermediate point 
h y virtual coordinate of intermediate point 
x x virtual coordinate of the endpoint 
y y virtual coordinate of the endpoint 
sb slope of the curve at the beaqinning point 
se address of floatina point variable where endina slope 
can be returned 
SEE ALSO: 


egeree, cger3sb, cacrse, Cader o1y cacr3m, cavcredc, 
egver3e, cgversi, caver3m 


igs 





caver3e cgvcri3e 


NAME 


caover3e = curve given three points and ending slope 


SYNOPSIS: 


DES 


a 
ae 
x = 
y - 
se > 
See 


caver3e(grvhsexry,se) 
float GrhsxrYrSes 


SRIPTICN: 


This routine draws a curve when given the 
coordinates of three points and the slope at the 
endpoint. The beaqinning point is defined by the present 
position of the beam. The intermediate point 1s shown 
by the coordinates qrh. The endpoint is defined by the 
coordinates x,y. The slope at the endpoint is given by 
SE. 


x virtual coordinate of intermediate point 


y virtual coordinate of tntermediate point 
x virtual coordinate of the endpoint 
y virtual coordinate of the endpoint 
slope of the curve at the endpoint 
ALSO: 
cqerece, cacr3sb, cacr3e, caqacrsy, cacr3m, cgvcrec, 


cover3b, caver3i, caver3m 
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eaversi Cavers! 


NAME? 


caver3i = curve aiven three points and intermediate 
slope 


SYNOPSTS: 


caver3si(grshsxrsyrsir,se) 
float gs-hexryrSirxse, 


DESCRIPTION: 


This routine draws a curve when given three points 
and the slope at the intermediate point. The beginnina 
point 1s defined by the present position of the beam. 
The intermediate point is given by the coordinates gerh. 
The endnoint is defined by the coordinates xvsye The 
slope at the intermediate point is given by si. The 
address where the value of the ending slope will be 
returned is shown by se. 


g ° x virtual coordinate of intermediate point 

h = y virtual coordinate of intermediate point 

x °° x virtual coordinate of the endpoint 

yi S y virtual coordinate of tne endpoint 

si - Slooe of the curve at the intermediate point 

se - address of floatina point variable where ending slope 


can be returned 


SEE raiser 


cacrec, cacr3b, cacrs3e, écersi, cacr3m, caverec, 
caver3e, caqver3m 


7? 
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cegover3m cgvcr3m 


NAME s 


cgover3m - curve given three pointsSr one at the relative 
maximum 


SYNOPSIS: 


caver3m(grhrxryrse) 
float GQrehrxryr*se-s 


DESCRIPTION: 


This routine draws a curve when given three points 
where the sloove at the intermediate point is equal to 


the slope of the chord joining the endooints. The 
beginning ooint is defined by the oresent position of 
the beam. The intermediate point 1S Shown by) the 
coordinates Gy an The endpoint is defined by the 


coordinates xrye The address where the value of the 
ending slooe will be returned 18 Shown by Se. 


g x virtual coordinate of intermediate point 
h y virtual coordinate of intermediate point 
x x virtual coordinate of the endpoint 
y y virtual coordinate of the endpoint 
se address of floatina ooint variable where ending slope 
can be returned 
SEE ALSO: 


Gaemee, cacrso, caqcerse, COCESI+ cacr3m, cavereec, 
cavers3e, cavcer3i 
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cavdrwa covdrwa 


NAME $ 


cavdrwa = set orientation in virtual coordinates 
SYNOPSIS: 


cavdrwalSrarfhexryrfsacrvav) 
int (xf) 0),acraver; 
float Sr QeXer Ve 


DESCRIPTION: 


This routine resets the orientation then calls the 
user's function with the two arguements. Scaling is by 
means of the Conographicw#le hardware registers therefore 
limited to the range of 1/64 to 63 63/64. Upon return 
the orevious orientation is restored. Thus the user is 
provided with a convenient means of recursively stacking 
the scale and offset settings. 


Ss - scale to be applied 
a - angle of desired rotation expressed in radians 
r - reflection desired 


no reflection 

reflect about x-axis 

reflect about yraxis 

reflect about both axes, (pi rotation) 
reflect about 01/4 line 

pi/e rotation counterclockwise 

pi/2 rotation clockwise 

reflect about 3/4 pi line 


SNOW OW — © 
ee 00 00 00 06 cf of 


x © x virtual coordinate which will correspond with 
oresent beam position and be the center of reflection 
and rotation 


y y virtual coordinate which will correspond with 
present beam position and be the center of reflection 
and rotation 


f = user defined function 
ac @ first arguement for user function 
avo second arguement for user function 
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SeEwALSO 


covorwr, 


cadrawa, 


cadrawr 





cgvd 


NAM 


SYN 


DES 


S$ = 
a -= 
f° - 


x = 


y = 


rwe cagvdrwr 


Es 


cgvdrwr = set orientation relative to present 
orientation in virtual coordinates 


OPSIS: 


caovdrwr(sSr,arr,xryrfracrav) 


int (*f)0),acrs,averr"float Srarxry3 


CRIPTION: 


This routine sets a new orientation relative to the 
present orientation then calls the user's function. 
Thus the reflections, rotations and scalina are 
cummulative. For best results it is recommended that 
most scaling factors be Il, if the hardware scaling 
provided here 1s insufficient it 1S recommended that 
scalina be effected by utilizing another cal! to cgvcord 
(note: there is not automatic stacking of cgvcord 
settings). Upon return the present orientation is 
restored. 


scale to be apolied 
anale of desired rotation expressed in radians 


reflection desired 
no reflection 
reflect about xeaxis 
reflect abcut yraxis 
reflect about both axes, (pi rotation) 
reflect about pi/4 line 
pi/e rotation counterclockwise 
pi/e rotation clockwise 
reflect about 3/4 poi line 


SNOW OCW = © 
eo 08 00 00 00 08 0 @@ 


x virtual coordinate which will correspond with 
oresent heam position and he the center of reflection 
and rotation 


y virtual coordinate which wil] corresoond with 
oresent beam oosition and be the center of reflection 


and rotation 


user defined function 


8 | 





ac = first arauement for user function 


avo second arguement for user function 


S12 #4 ss 


covdrwar cgdrawar cadrawr 
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cavelpogq cqvelpa 


NAME $ 


coveloq - draw elliose quarters itn virtual coordinates 


SYNOPSIS: 


caveloq(a,d,xerye,a,se) 
int QQ? 
float arbsxeryer,xse; 


DESer 1 F 1nOh: 


This routine draws the soecified number of quarters 
of an elliose defined by its center and one endpoint of 
each axis. The ending slope is returned in se. Present 
beam position 1s taken as the endpoint of one axis and 
drawing starts in the direction of the other axis 
endooint. 


a °° x virtual coordinate of center 
bd °° y virtual coordinate of center 
xe = x virtual coordinate of other axis endpoint 
ye - y virtual coordinate of other axis endpoint 
qQ ° number of additional) auarters 
Oe one quarter only 
ee semicell)iose 
es two additional auarters, total three quarters 
oye full ellipse 
se = address of floating oOoIint variable where ending slope 
can be returned 
SEE ALSO: 


cqelosar caelose, caelosa 
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cavline cqavline 


NAME: 
cgvline - line in virtual coordinates 
SYNOPSIS: 
cavline(x,y) 
float xry-, 
DESERTPTION: 
In this routine the beginning point is defined as 


the present position of the beam. The endpoint is 
defined by the coordinates xvy. 


x - x virtual coordinate of the endpoint 
y y virtual coordinate of the endpoint 
SEE ALSO: 

caline 
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cavmove 


NAME $ 


cavmove = move in virtual coordinates 


SNOOP STS: 


cqvmove(x,y) 
float Xe Ye 


UBSOCRIPTION: 


This routine moves” the 
position without drawing. 


x * x virtual coordinate of the 


yO y virtual coordinate of the 


see ASO: 


cgmove 
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beam to 


endpoint 


endpoint 


the 


covmove 


indicated 





cawrmem caqwrmem 


NAME: 
caowrmem = write to memory 
SYNOPSIS: 


caowrmem(bsnew) 
Int DOsensekwe 


DESCRIPTION: 


This routine writes the specified number ‘of words 
into the Conographic-le font memory starting at the 
supplied base address. 


2 value to be loaded tnto the font base register 

n = number of words to be written 

cS array of at least size n where the words for memory 
are 

SEE ALSO: 
cardmem 
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